(run-mode-hooks): Docstring improvement.

diff --git a/lisp/subr.el b/lisp/subr.el
index 86616265c59ceaa5ba97fe065b74293f93a84d98..f890caf66e47606bfc02fc7e8713e91a38f4f846 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -1219,7 +1219,8 @@ if it is empty or a duplicate."
 Execution is delayed if `delay-mode-hooks' is non-nil.
 If `delay-mode-hooks' is nil, run `after-change-major-mode-hook'
 after running the mode hooks.
-Major mode functions should use this."
+Major mode functions should use this instead of `run-hooks' when running their
+FOO-mode-hook."
   (if delay-mode-hooks
       ;; Delaying case.
       (dolist (hook hooks)